# Q. What is this file?
# A. This file contains options which allow you to configure your multiworld experience while allowing
#    others to play how they want as well.
#
# Q. How do I use it?
# A. The options in this file are weighted. This means the higher number you assign to a value, the
#    more chances you have for that option to be chosen. For example, an option like this:
#
#    map_shuffle:
#      on: 5
#      off: 15
#
#    Means you have 5 chances for map shuffle to occur, and 15 chances for map shuffle to be turned
#    off.
#
# Q. I've never seen a file like this before. What characters am I allowed to use?
# A. This is a .yaml file. You are allowed to use most characters.
#    To test if your yaml is valid or not, you can use this website:
#        http://www.yamllint.com/
#    You can also verify that your Archipelago options are valid at this site:
#        https://archipelago.gg/check

# Your name in-game, limited to 16 characters.
#     {player} will be replaced with the player's slot number.
#     {PLAYER} will be replaced with the player's slot number, if that slot number is greater than 1.
#     {number} will be replaced with the counter value of the name.
#     {NUMBER} will be replaced with the counter value of the name, if the counter value is greater than 1.
name: Player{number}

# Used to describe your yaml. Useful if you have multiple files.
description: Default Minishoot Adventures Template

game: Minishoot Adventures
requires:
  version: 0.6.6 # Version of Archipelago required for this yaml to work as expected.

Minishoot Adventures:
  ################
  # Game Options #
  ################
  progression_balancing:
    # A system that can move progression earlier, to try and prevent the player from getting stuck and bored early.
    # 
    # A lower setting means more getting stuck. A higher setting means less getting stuck.
    #
    # You can define additional values between the minimum and maximum values.
    # Minimum value is 0
    # Maximum value is 99
    random: 0
    random-low: 0 # random value weighted towards lower values
    random-high: 0 # random value weighted towards higher values
    random-range-0-99: 0 # random value between 0 and 99
    disabled: 0 # equivalent to 0
    normal: 50 # equivalent to 50
    extreme: 0 # equivalent to 99

  accessibility:
    # Set rules for reachability of your items/locations.
    # 
    # **Full:** ensure everything can be reached and acquired.
    # 
    # **Minimal:** ensure what is needed to reach your goal can be acquired.
    full: 50
    minimal: 0

  npc_sanity:
    # Randomizes the freeable NPCs in the world, making them obtainable from any source.
    'false': 50
    'true': 0

  scarab_sanity:
    # Randomizes the scarabs in the world.
    'false': 50
    'true': 0

  spirit_sanity:
    # Randomizes the spirit in the world.
    'false': 50
    'true': 0

  shard_sanity:
    # Randomizes the XP shards "groups" (not individual crystals) in the world.
    'false': 50
    'true': 0

  key_sanity:
    # Randomizes the small keys of dungeons in the world.
    'false': 50
    'true': 0

  boss_key_sanity:
    # Randomizes the boss keys of dungeons in the world.
    'false': 50
    'true': 0

  add_trap_items:
    # Add trap items to the item pool.
    # In Minishoot' Adventures, trap items will force the primordial scarab to be a little chatty and make references to other games.
    # (some of which are playable on Archipelago !)
    'false': 50
    'true': 0

  trap_items_appearance:
    # Set the appearance of trap items.
    # When set to "Major Items Only", trap items will be disguised as major items.
    # When set to "Junk Items Only", trap items will be disguised as junk items.
    # When set to "Anything", trap items can be disguised as any other items.
    major_items_only: 50
    junk_items_only: 0
    anything: 0

  shop_cost_modifier:
    # Set the super crystal cost modifier for items in shops.
    # The value can be between 10 and 200.
    # The value is a percentage, so 100 means that the cost will be the same as in vanilla.
    #
    # You can define additional values between the minimum and maximum values.
    # Minimum value is 10
    # Maximum value is 200
    100: 50
    random: 0
    random-low: 0 # random value weighted towards lower values
    random-high: 0 # random value weighted towards higher values
    random-range-10-200: 0 # random value between 10 and 200

  scarab_items_cost:
    # Set the scarab cost for items in shops.
    # The value can be between 1 and 3.
    # The value is the number each item will cost in scarabs.
    # Note that extra scarabs will remain in the item pool.
    #
    # You can define additional values between the minimum and maximum values.
    # Minimum value is 1
    # Maximum value is 3
    3: 50
    random: 0
    random-low: 0 # random value weighted towards lower values
    random-high: 0 # random value weighted towards higher values
    random-range-1-3: 0 # random value between 1 and 3

  spirit_tower_requirement:
    # Set the number of spirits required to enter the Spirit Tower.
    # The value can be between 0 and 8.
    # This setting does not affect the total number of spirit items in the world, only the number required to access the tower.
    #
    # You can define additional values between the minimum and maximum values.
    # Minimum value is 0
    # Maximum value is 8
    8: 50
    random: 0
    random-low: 0 # random value weighted towards lower values
    random-high: 0 # random value weighted towards higher values
    random-range-0-8: 0 # random value between 0 and 8

  show_archipelago_item_category:
    # When enabled, Archipelago items sprites will indicate if its an important item (with an arrow pointing up), an helpful one (with the default icon), or not important (with a black and white sprite).
    'false': 0
    'true': 50

  blocked_forest:
    # Replace the bushes of the secret pond in the forest with rocks. This make the south forest area blocked until you have the supershot.
    # With this option enabled, the forest area no longer contains sphere 0 locations locked behind a particular difficult fight without any additional offensive capabilities.
    'false': 0
    'true': 50

  ignore_cannon_level_requirements:
    # By default, the game will ensure that progressive cannon levels are accessible before fights in late game areas.
    # So for example, you will be able to enter Dungeon 3 in logic, but you will need the cannon level 4 to beat the boss, or items behind fights in this dungeon.
    # If you enable this option, the cannon level requirements will be ignored, and the logic will expect you to be able to beat all fights with a level 1 cannon.
    'false': 50
    'true': 0

  boostless_springboards:
    # When this setting is off, the logic will require you to use the boost to jump from springboards.
    # When this setting is on, the dash will be enough to jump from springboards logically, which make the dash even more useful.
    'false': 50
    'true': 0

  boostless_spirit_races:
    # When this setting is off, races against spirits will logically require the boost.
    # When this setting is on, the logic will assume that you can complete those races with the dash instead.
    # Note that you will still need the boost to complete the the spirits races of the Beach, Scarab Temple and Sunken City.
    # Also note that this setting may require you to farm some XP to level up your speed.
    'false': 50
    'true': 0

  boostless_torch_races:
    # When this setting is off, timed torch races will logically require the boost.
    # When this setting is on, the logic will assume that you can complete those races without it.
    # Note that this setting may require you to farm some XP to level up your speed.
    'false': 50
    'true': 0

  enable_primordial_crystal_logic:
    # When this setting is on, the Primordial Crystal will be considered in logic to blow up rocks and walls.
    # When this setting is off, the logic will assume that you imperatively need Supershot to do that.
    'false': 50
    'true': 0

  progressive_dash:
    # When enabled, the game will fuse the Dash and the Spirit Dash into two cumulative progressive upgrades.
    # The first upgrade will always allow you to dash, and the second one will allow you to dash through bullets.
    'false': 50
    'true': 0

  dashless_gaps:
    # When set on "Needs Dash", you will need the dash to cross gaps, regardless of their size.
    # When set on "Needs Boost", you will be able to logically cross gaps with the boost if the gap is small enough.
    # When set on "Needs neither", you will be able to cross certains, very tight gaps without any upgrade.
    # Note that this last value may require you to farm some XP to level up your speed.
    needs_dash: 50
    needs_boost: 0
    needs_neither: 0

  completion_goals:
    # Set the goals required to finish the game.
    # * Dungeon 5 : Beat the boss of Dungeon 5 and get to the normal ending.
    # * Snow : Beat the Unchosen inside the tree and get to the true ending.
    # * Dungeon 5 and Snow : Beat both the normal and true ending.
    # * Spirit Tower : Collect all spirits and get to the Spirit Tower ending. The number of spirits required to enter the tower can be set with the "Spirit Tower Requirement" option.
    dungeon_5: 50
    snow: 0
    dungeon_5_and_snow: 0
    spirit_tower: 0

  ###########################
  # Item & Location Options #
  ###########################
  local_items:
    # Forces these items to be in their native world.
    []

  non_local_items:
    # Forces these items to be outside their native world.
    []

  start_inventory:
    # Start with the specified amount of these items. Example: "Bomb: 1"
    {}

  start_hints:
    # Start with these item's locations prefilled into the ``!hint`` command.
    []

  start_location_hints:
    # Start with these locations and their item prefilled into the ``!hint`` command.
    []

  exclude_locations:
    # Prevent these locations from having an important item.
    []

  priority_locations:
    # Prevent these locations from having an unimportant item.
    []

  item_links:
    # Share part of your item pool with other players.
    []

  plando_items:
    # Generic items plando.
    []
